.TH std::allocator::destroy 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::allocator::destroy \- std::allocator::destroy

.SH Synopsis
   Defined in header <memory>
   void destroy( pointer p ); \fB(1)\fP \fI(until C++11)\fP
   template< class U >            \fI(since C++11)\fP
   void destroy( U* p );      \fB(2)\fP (deprecated in C++17)
                                  (removed in C++20)

   Calls the destructor of the object pointed to by p.

   1) Calls p->~T().
   2) Calls p->~U().

.SH Parameters

   p - pointer to the object that is going to be destroyed

.SH Return value

   \fI(none)\fP

   Defect reports

   The following behavior-changing defect reports were applied retroactively to
   previously published C++ standards.

     DR    Applied to         Behavior as published               Correct behavior
   LWG 400 C++98      p was cast to T*, which is the type of removed the redundant cast
                      p

.SH See also

   destroy  destructs an object stored in the allocated storage
   \fB[static]\fP \fI(function template)\fP
